home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 008 / vincent.arc / VINCENT.PRT < prev    next >
Encoding:
Text File  |  1979-12-31  |  8.5 KB  |  237 lines

  1.    Atlantic Information Management Inc.                        June 16, 1985
  2.  
  3.  
  4.     
  5.                                  VINCENT
  6.     
  7.     
  8.    VINCENT is a very easy to use screen painter designed to produce screens
  9.    that are useable in remote applications for bulletin board systems.  Two
  10.    versions of each screen are  produced.  One  with  the  ANSI.SYS  escape
  11.    sequences embedded in it and  the  other  in  direct  video  ram  buffer
  12.    format. Each screen also has  an  associated  data  definition  file  to
  13.    locate input data areas. All attributes that  are  supported  by  direct
  14.    video ram I/O (0-255) are accessible through VINCENT.
  15.     
  16.     
  17.    SCREEN PAINTER  - VINCENT COMMAND
  18.     
  19.         To execute the screen painter, enter the command
  20.     
  21.             C> VINCENT screen-name
  22.     
  23.             Where "screen-name" is the name for a screen. This must
  24.             be specified WITHOUT a .qualifier as one is created.
  25.     
  26.             EXAMPLE:
  27.     
  28.                 VINCENT  test
  29.     
  30.                     will create the following files:
  31.     
  32.                          TEST.SCR  - screen image
  33.     
  34.                          TEST.DFD  - Data field definitions
  35.     
  36.                          TEST.DAT  - Empty file to contain data input.
  37.     
  38.                          TEST.VRM  - file containing video ram image
  39.     
  40.             DATA FIELDS
  41.     
  42.                  To define a DATA INPUT field, enter '@' characters
  43.                  where the data will be entered.
  44.     
  45.                  EXAMPLE :
  46.     
  47.     
  48.                       OPTION ===> @@@@@
  49.     
  50.                             Defines an input field 5 positions long.
  51.     
  52.                  All data definitions are written to the .DFD file
  53.                  in the format :
  54.     
  55.  
  56.  
  57.    
  58.  
  59.                                           1                                   
  60.    Atlantic Information Management Inc.                        June 16, 1985
  61.  
  62.  
  63.                       LINE COL LENGTH RAM-ATTRIBUTE  ANSI-ESCAPE-SEQUENCE
  64.     
  65.                  Where LINE and COL are the starting coordinates of the
  66.                  input area, LENGTH is the length and ATTRIBUTE is a number
  67.                  from 0 to 255 representing the video ram attribute
  68.                  character (i.e. 7 is white on black). The ANSI-ESCAPE-SEQ
  69.                  is the escape sequence that ANSI.SYS uses to create this
  70.                  color. There is one line in this file for each data field.
  71.                  The DFD file is in ASCII format and can be listed using
  72.                  "type".
  73.     
  74.             VIDEO RAM FILE (.VRM)
  75.     
  76.             The video ram file (.VRM) contains 4000 characters which
  77.             can be written directly to the video ram buffer. The
  78.             data stream is in the format  character-attribute pairs
  79.             running form screen location 1,1 tp 25,80 ; left to right,
  80.             top to bottom.
  81.     
  82.             USING THE SCREEN PAINTER
  83.     
  84.             The screen painter has a simple screen editor contained
  85.             within it. Generally, you can type anywhere on the screen
  86.             and that will be placed into the file. Additionally the
  87.             following commands are available:
  88.     
  89.                      KEY       FUNCTION
  90.     
  91.                      ^a         - APPEND  a line after the current line
  92.                      ^d         - DELETE  a line
  93.                      ^l         - LAST    last character repeat
  94.                      ^q         - QUIT    without saving data
  95.                      ^r         - REPEAT  a line
  96.                      ^p         - PAINT   paint colors
  97.                      ^u         - UNDO    undo from last save
  98.                      ^w         - WRITE   to file (save)
  99.                      ^x         - XPAINT  repeat last paint color
  100.                      INS        - INSERT  character
  101.                      DEL        - DELETE  character
  102.                      ESC        - ESCAPE  (quit)
  103.                      PGDN       - PGDN    go down page
  104.                      PGUP       - PGUP    go up page
  105.                      HOME       - HOME    go to line 1 ,column 1
  106.                      END        - END     Erase to end of line
  107.                      CURSOR(s)  - CURSOR  Move cursor on screen
  108.                      ENTER      - ENTER   redraw screen
  109.                      --->|      - TAB     forward
  110.                      |<---      - TAB     backward
  111.  
  112.  
  113.  
  114.  
  115.  
  116.    
  117.  
  118.                                           2                                   
  119.    Atlantic Information Management Inc.                        June 16, 1985
  120.  
  121.  
  122.     
  123.             When the ^P key is depressed a color palette is displayed. To
  124.             abort color selection you can use the ESC key. Select one of
  125.             the colors by positioning the cursor over the color combination
  126.             desired and depress enter. The input screen will then be
  127.             redisplayed. To color an area on the screen do the following :
  128.     
  129.                  1) Select the starting position of where to color by
  130.                     positioning the cursor and depressing the enter key.
  131.                     This will start the painting operation.
  132.     
  133.                  2) Use the cursor keys to position the color area and
  134.                     depress ENTER to complete the operation.
  135.     
  136.                  3) To abort window selection use the ESC key.
  137.     
  138.     
  139.             Data in in the input file is NOT saved each time
  140.             the screen is cleared or any special commands are used.
  141.             Use the (^w write) command to explicitly save the data.
  142.     
  143.             WARNING - WAIT FOR THE SCREEN TO BE COMPLETELY REWRITTEN
  144.                       BEFORE ENTERING ANY OF THE CONTROL KEYS.
  145.     
  146.     
  147.        DISPLAYING A SCREEN
  148.     
  149.     
  150.             The VINC utility is provided which can display a screen
  151.             and retrieve the users input data. THIS IS A VERY SIMPLE
  152.             program written in "C" and provided in source and executable
  153.             form. A much more elaborate program could be created.
  154.     
  155.             To use VINC.
  156.     
  157.                FROM BASIC:
  158.     
  159.                       00..... SHELL "VINC screen-name"
  160.                               ' file screen-name.DAT has data in it
  161.                               ' one ASCII record for each data field.
  162.                               ' These are written to the file from left to
  163.                               ' right, top to bottom.
  164.     
  165.                FROM .BAT
  166.     
  167.                       VINC screen-name
  168.     
  169.                FROM "C"
  170.     
  171.                       1) AS SYSTEM COMMAND
  172.     
  173.  
  174.  
  175.    
  176.  
  177.                                           3                                   
  178.    Atlantic Information Management Inc.                        June 16, 1985
  179.  
  180.  
  181.                            system("vinc screen-name") ;
  182.     
  183.                       2) AS A SUB FUNCTION
  184.     
  185.                          Alter the code as follows :
  186.     
  187.                          REMOVE
  188.                                  main(argc,argv)
  189.                                    int argc;
  190.                                    char *argv[];
  191.                          INSERT
  192.                                  vinc(name)
  193.                                    unsigned char name[];
  194.     
  195.                          REMOVE
  196.                              strcpy(filename,argv[1]);
  197.                          INSERT
  198.                              strcpy(filename,name);
  199.     
  200.                       3) VINC has been tested using the C86 compiler
  201.                          small model. (V2.20J)
  202.     
  203.           Finally, there is one aditional utility provided: SHOW which
  204.           is identical to vinc but uses the video ram image (.VRM) file for
  205.           very fast local screen processing.
  206.  
  207.           A quick note for use of VINCENT with RBBS-PC:
  208.  
  209.           VINCENT should help build/modify color menu screens easily.
  210.           To create a color graphics welcome menu, for example:
  211.  
  212.           VINCENT WELCOMEC
  213.           RENAME WELCOMEC.SCR WELCOMEC
  214.  
  215.           In editting a screen, an IBM graphic character can be created
  216.           with an ALT-asciicode entry. Characters can be repeated with
  217.           the ^r command.
  218.  
  219.           VINCENT writes .SCR files beginning with a clear screen escape
  220.           sequence. Each screen is written out as 24 lines. If you want
  221.           a shorter screen use an editor or other utility to delete
  222.           records as necessary.
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.    
  234.  
  235.                                           4                                   
  236.  
  237.